home *** CD-ROM | disk | FTP | other *** search
/ Atari Gold / Atari Gold.iso / om_basic / vollver3.03 / is_lib.doc < prev    next >
Encoding:
Text File  |  1988-10-01  |  4.0 KB  |  92 lines
  1. Is_Entry(Handle,Nr,Position,Laenge,Typ)
  2.      Handle    Nummer der Isam-Datei (0-10)
  3.      Nr        Nummer des Suchkriteriums (1-10)
  4.      Position  Stelle des Suchkriteriums im Stammrecord (0- )
  5.      Laenge    Länge des Suchkriteriums (1- )
  6.      Typ       0=ASCII, 1=aplhabetisch, 2=numerisch
  7.      Mit  Is_Entry werden die  Parameter der  Sortierkriterien  für
  8.      Is_Open gesetzt. Die  Handlenummer wird als interne Identifika-
  9.      tionsnummer  benötigt und  hat  nichts  mit der  physikalischen
  10.      Basic-Dateinummer zu tun.  Die Nummer  des  Suchkriteriums wird
  11.      ebenso  intern  verwendet  und  kann  beliebig vergeben werden.
  12.      Position ist die Position des Suchmerkmals innerhalb des Stamm-
  13.      records,  d.h.  vom  ersten  Byte  der  FIELD-Anweisung bis zum
  14.      Start des Suchbegriffes.
  15.  
  16. Is_Open(Handle,Name$,Länge,Filenr,Anzahl)
  17.      Handle    Nummer der Isam-Datei (0-10)
  18.      Name$     Name der Datei
  19.      Länge     Recordlänge der Stammdatei
  20.      Filenr    BASIC-Dateinummer (1-15)
  21.      Anzahl    Anzahl der Such- bzw. Sortierkriterien
  22.      Die   Stammdatei  und  die  dazugehörigen   Suchdateien  werden
  23.      eingerichtet bzw. wiedereröffnet.
  24.      Die  eigenen FIELD-Anweisungen für die  Stammdateien sollten ab
  25.      Zeilennummer  63210 eingetragen werden.  Für jede Handle-Nummer
  26.      ist ab dort ein Bereich reserviert.
  27.      BASIC-Dateinummer gibt die physikalische Dateinummer an mit der
  28.      die Stamm-Datei geöffnet wird. Zusätzlich wird für je Suchdatei
  29.      eine weitere physikalische Dateinummer benötigt.
  30.  
  31. Is_Close(Handle)
  32.      Handle    Nummer der Isam-Datei (0-10)
  33.      Schließt die Stamm-Datei und alle Suchdateien.
  34.  
  35. Is_Update(Handle)
  36.      Handle    Nummer der Isam-Datei (0-10)
  37.      Sichert  den Dateiinhalt auf Disk,  schließt jedoch die Datei
  38.      nicht. Nach Is_Update kann das Gerät ohne Datenverlust ausge-
  39.      schaltet werden.
  40.  
  41. Is_Backup(Von$,Nach$,Name$,Anzahl)
  42.      Von$      Quellpathname
  43.      Nach$     Zielathname
  44.      Name$     Name der Datei
  45.      Anzahl    Anzahl der Such- bzw. Sortierkriteriené
  46.      Die  Stammdatei  und  die  dazugehörigen  Suchdateien  werden
  47.      kopiert.  Die Stammdatei (".DAT") wird zu ".BAK",  die Index-
  48.      dateien (".I01") werden zu ".B01".
  49.      ACHTUNG:  Diese  Funktion  darf nur bei  geschlossener  Datei
  50.      angewendet werden.
  51.  
  52. Is_Kill(Von$,Name$,Anzahl)
  53.      Von$      Pathname
  54.      Name$     Name der Datei
  55.      Is_Kill dient zum löschen einer Datei.
  56.      ACHTUNG:  Diese  Funktion  darf nur bei  geschlossener  Datei
  57.      angewendet werden.
  58.  
  59. Is_Insert(Handle)
  60.      Handle    Nummer der Isam-Datei (0-10)
  61.      Sortiert den Datensatz, der sich gerade im Dateibuffer befin-
  62.      det, in die Datei ein.
  63.  
  64. Is_Replace(Handle,Recordnr)
  65.      Handle    Nummer der Datei (0-10)
  66.      Recordnr  Nummer des Datensatzes (2- )
  67.      Ersetzt den Datensatz mit der angegebenen Recordnr durch  den
  68.      neuen Datensatz, der sich gerade im Dateibuffer befindet.
  69.  
  70. Is_Delete(Handle,Recordnr)
  71.      Handle    Nummer der Isam-Datei (0-10)
  72.      Recordnr  Nummer des Datensatzes (2- )
  73.      Löscht den Datensatz mit der angegebenen Recordnummer.
  74.  
  75. Is_Search(Handle,Nr,Recordnr)
  76.      Handle    Nummer der Isam-Datei (0-10)
  77.      Nr        Nummer des Suchkriteriums (1-10)
  78.      Der Suchbegriff,  nach dem gesucht werden soll,  steht an der
  79.      entsprechenden Stelle im Dateibuffer der Stammdatei.
  80.      Als Rückgabeparameter erhält man:
  81.      Recordnr  Nummer des Datensatzes
  82.      Wird der Suchbegriff nicht gefunden, gibt Is_Search den (z.B.
  83.      alphabetisch) nächsten.  Gibt es keinen Datensatz mehr,  wird
  84.      eine Null zurückgegeben.
  85.      Übergibt  man  jedoch eine Null in Nr,  wird ab  dem  letzten
  86.      gesuchten Eintrag weitergesucht.
  87.      Übergibt man -1 in Nr, wird ab dem letzten gesuchten  Eintrag
  88.      rückwärts gesucht.
  89.      Um  den letzten Eintrag zu finden, sucht man am  besten  nach
  90.      "ZZZZZZZ"  bzw. CHR$(255)*n  oder "999999" (je nach Suchart),
  91.      danach einmal zurück und einmal wieder vorwärts.
  92.